home *** CD-ROM | disk | FTP | other *** search
/ Best of www.BestZips.com (Collector's Edition) / Best of WWW.BESTZIPS.COM Collector's Edition (JCSM Shareware) (JCS Marketing).ISO / bbs_syst / cash3lot.zip / Lotto.doc < prev    next >
Text File  |  1996-10-19  |  9KB  |  253 lines
  1.  
  2.  
  3.                                Cash3 Lotto(TM)
  4.                                  Version 3.5
  5.  
  6.                              Copyright (c)1996
  7.                              By Steven W. Lucey
  8.                             All rights reserved.
  9.  
  10.                             Support boards are:
  11.  
  12.                             The Power Board BBS 
  13.                             - Steven W. Lucey - 
  14.                         - Main Number 502.447.6649-
  15.                          
  16.  
  17.  
  18.                                 C O N T E N T S
  19.                                =================
  20.  
  21.         Warranty ............................................ 1
  22.         Copyright notice .................................... 2
  23.         Distribution ........................................ 2
  24.         Description ......................................... 2
  25.         Setup................................................ 3
  26.     Batch file example................................... 4
  27.     Config file example.................................. 4
  28.     Game play options.................................... 4
  29.     Miscellaneous........................................ 5
  30.     Fossil Drivers....................................... 6
  31.     Environment variables................................ 6
  32.     486DX CPU............................................ 7
  33.     Contacting the Author.................................8
  34.         Sources for the latest releases.......................9
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                                    Warranty
  41.  
  42.  
  43.     This product is provided "as is" without warranty of any kind. The entire
  44.     risk as to the results and  performance of the program is assumed by you.
  45.     Futhermore, the  author does  not warrant, guarantee, or  make any  other
  46.     representations regarding  the use of,  or the  results of the use of the
  47.     program,  and you  rely on the  program and  results  solely at  your own
  48.     risk.  The author  cannot and  will not accept  responsibility for system
  49.     damage, loss of profit, or any other special, consequential or incidental 
  50.     damages  resulting  from  the  use  or  inability  to  use this  product.
  51.  
  52.                                    Copyright
  53.  
  54.     Cash3 Lotto (Copyright (c) 1996 by Steven W. Lucey) is being
  55.     distributed as Shareware. Under this concept you may use the  SHAREWARE  
  56.     (unregistered) version for a reasonable period of time (30 days) for 
  57.     evaluation after which you should either register your copy or discontinue
  58.     usage.
  59.  
  60.  
  61.                                  Distribution
  62.  
  63.     You  are encouraged to distribute Cash3 Lotto provided that all files
  64.     contained in the archive are distributed in their original and
  65.     unmodified state.
  66.  
  67.                                   Description
  68.     
  69.     Cash3 Lotto is a door program that enables callers to take a chance at
  70.     winning a straight-box draw of 3-numbers. SysOps can award prizes for
  71.     those who win. Ie., I use this door program as a give-away for some
  72.     useful DOS/Windows utilities that I write.
  73.  
  74.     Cash3 Lotto was compiled with QUICKBASIC (tm) 4.5 and DOORFRAME 4.9 (tm).
  75.       
  76.                   ==========================================
  77.  
  78. SETUP:
  79. ======
  80. 1) Unzip Cash3 Lotto into a directory from which you plan to run the door
  81.     from. You may name this directory anything you wish. 
  82.  
  83.  
  84. 2) Using a text editor, create a config file with the following info:
  85.     Line 1: Path & Door drop file   ex: c:\bbs\door.sys
  86.     Line 2: SysOp First Name        ex: Steven
  87.     Line 3: SysOp Last Name         ex: Lucey  (or leave this line blank if using a handle)
  88.     Line 4: Registration #          ex: 00000 if unregistered  
  89.     
  90.     (a sample config file is included should you want to simply edit this file)
  91.  
  92.  
  93. 3) Using a text editor, create a batch file with the following info:
  94.     Line 1: cd\PATH_TO_DOOR   ex: c:\doors\cwords 
  95.                     
  96.     Line 2: lotto ???.cfg    ex: cwords cwords.cfg
  97.                   (You may name your config file anything)
  98.     Line 3: cd\BBS          ex: cd\pcb
  99.     Line 4: board          :some BBS's require a command to re-start the BBS
  100.  
  101.    (a sample batch file is included should you want to simply edit this file)
  102.  
  103. 4) Create a text file called 'win.txt' in your Cash3 directory that contains
  104. from one to four lines of text that you want displayed to your players that choose
  105. all three correct numbers.
  106.  
  107.  
  108.  
  109.     BATCH FILE EXAMPLE
  110.     ==================
  111.  
  112. Example batch file used to call the door using DOOR.SYS:
  113. ---------------------------------------------------------
  114. @echo off
  115. cd\doors\lotto
  116. lotto lotto.cfg
  117. cd\pcb\node1
  118. board
  119.  
  120.     CONFIGURATION FILE EXAMPLE
  121.     ==========================
  122. Example config file:
  123. --------------------
  124. c:\PCB\NODE1\DOOR.SYS
  125. The Power Board BBS
  126. Steven
  127. Lucey
  128. 00000
  129.  
  130.     GAME PLAY OPTIONS
  131.     =================
  132.  
  133.  
  134. When the door starts, you enter 3 numbers (0-9). After that the program
  135. will generate 3 random numbers and test to see if your 3 numbers are a 
  136. match (in any order).
  137. If so, the contents of your 'win.txt' file will be displayed on screen.
  138. Also, a 'winners.dat' file is created (or appended) with the winners
  139. name, the 3 numbers he/she picked, and the 3 numbers the computer randomly
  140. selected (for verification purposes). Also, another file is created called
  141. 'winners.txt' (this file contains names of previous winners).
  142. If you do not win, a simple 'sorry' is displayed and players are asked
  143. if they wish to try again....max of 3 attempts per entry.
  144.  
  145. Note: Limitations on the contents of your 'win.txt' file:
  146.     - Max of 4 lines 
  147.     - 60 characters max per line
  148.  
  149.        
  150.                                 MISCELLANEOUS NOTES
  151.                                 ===================
  152.  
  153. Cash3 Lotto requires DOS 3.x and up since all files are opened in SHARED mode.
  154.  
  155. The DOOR.SYS used is the standard 52 line GAP (tm) file.
  156.  
  157. If ANY Basic error is encountered, it will be printed to the screen and written
  158. to DFRAME.ERR. Door will then exit back to the BBS cleanly.
  159.  
  160.  
  161. Fossil Driver Support
  162. ---------------------
  163. Supports the use of Fossil drivers.  To tell the door to use the
  164. Fossil driver instead of the standard COM ports, just put /FD on the command
  165. line when running the door. For example:
  166.      lotto.lottoCFG /FD
  167. indicates that a Fossil driver is present and should be used. If no Fossil
  168. driver is detected, the door will print a message to that effect and exit
  169. the door gracefully.
  170.  
  171. Environment Variables
  172. ---------------------
  173. Supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  174. COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  175. number after the configuration filename. Let's assume you want to use COM1 
  176. and IRQ5. The command line passed would be:
  177.     lotto lotto.CFG /5  or
  178.     lotto lotto.CFG /%IRQ%  for the environment variable.
  179. The /5 tells the door to use IRQ5 rather than the standard IRQ4 that
  180. is normally used with COM1. No /x parameter is needed for the standard IRQ's.
  181.  
  182. When specifying the location of the system file on line 1 of the config
  183. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%.
  184. Some examples:
  185.  PCBoard: 
  186.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  187.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  188.  
  189. Non-PCBoard systems may use the PCB environment variables by setting them
  190. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  191.  SET PCBDRIVE=C:
  192.  SET PCBDIR=\BBSDIR
  193.  SET PCBNODE=1
  194.  
  195. 486DX CPU's
  196. -----------
  197. The math coprocessor in 486DX CPUs cannot handle floating point math which
  198. all MicroSoft Basic's use. This can show up as an ERROR 5, a keyboard 
  199. timeout, etc.
  200.  
  201. Fortunately there is an easy fix for this problem. Simply place the following
  202. line in the AUTOEXEC.BAT file:
  203.  
  204. SET NO87=ON
  205.  
  206. Contacting the Author
  207. =-=-=-=-=-=-=-=-=-=-=
  208.  
  209.     The Support BBS is:
  210.     -------------------
  211.         The Power Board BBS..........502-447-6649
  212.     
  213.     On Prodigy:
  214.     -----------
  215.         Member ID....................ZYAH67A    
  216.  
  217.     On Compuserve:
  218.     --------------
  219.         Member ID....................104542,2570
  220.  
  221.     Internet E-mail:
  222.     ----------------
  223.         Address #1......................steven_lucey@prodigy.com
  224.         Address #2......................slucey@powerbrd.win.net
  225.         Address #3......................104542.2570@compuserve.com
  226.         Address #4......................steven4142@aol.com
  227.  
  228.     Voice:
  229.     ------
  230.         .............................502-447-3474 (M-F 8-2p EST.)
  231.  
  232.  
  233. **NOTE: Registrations are taken from all of the above. Your registration number will
  234.     be available within 24 hours on the Support BBS and/or thru the Internet 
  235.     (or online service) if you so choose (please leave your Internet address or 
  236.     online service ID).
  237.  
  238.     Fastest registration:
  239.     ---------------------
  240.     Additionally, SysOps wishing to register a door game (via Visa or MasterCard 
  241.     or Check) may also call the support BBS (at 502-447-6649) and sign on using the user-id 
  242.     BBS DOORS and the password REGISTER. This will by-pass ALL the log-in files and 
  243.     take you immediately to the registration screen.
  244.  
  245.  
  246. Current Versions:
  247. =-=-=-=-=-=-=-=-=
  248.     
  249. The best source for current versions of our door games:
  250.     
  251.             The Support BBS............502-447-6649 
  252.             WWW Home Page..............http://www.win.net/~powerbrd
  253.